This file contains the dictionary entries called words of the FORTH
compiler / interpreter, it should be used to check the semantics and number
of stack entries of the words. A short example follows of the syntax used to
desribe them.
DUP [ W32a -> W32a W32a ] (special) this word is used to duplicate the top 32 bit word on the stack.
The entry starts of with the word being defined, next in the square
brackets comes the stack usage. The values on the stack before the call of
DUP are shown to the left of the -> those left on the stack after the call
are shown on the right. Each stack element definition is made up of three
parts the first part is a letter showing the type of the stack element.
A = address
U = unsigned
S = signed
W = a word (address or unsigned or signed)
The next part is a number showing the number of bits that the element
takes up.
The final part is a letter which is used to distinguish between stack
elements i.e.
ROT [ W32a W32b W32c -> W32b W32c W32a] (main) this word is used to rotate
the top three stack elements, the bottom one of these becomes the top.
Next comes a name in brackets, this is the dictionary that the word is
contained in, currently there are three basic dictionaries defined:
1. main - this is the dictionary which contains the words that are
interpreted from the prompt, as well as basic stack manipulation there arewords for I/O, dictionary manipulation, etc.
2. compiler - this dictionary is only available when compiling a new word, it contains words for iteration, selection, etc.
3. special - this dictionary contains the most used words from the main dictionary. The are compiled in a special way so that they run much faster than ordinary words.
Finally comes a description of the word its actions, semantics, and usual uses.
DUP [ W32a -> W32a W32a ] (special) this word is used to duplicate the top 32 bit word on the stack.
ROT [ W32a W32b W32c -> W32b W32c W32a] (main) this word is used to rotate
the top three stack elements, the bottom one of these becomes the top.
